GUI Help > Dialogs > saveDialog

saveDialog
str fileName=saveDialog(str caption, str fileTypes, [str initDir])

Description:
Displays a standard save-file dialog. This allows the user to select a filename to save their work to. This is usually used for saving documents in a Level Editor for example. saveDialog does not create or write anything to the file the user selected, your code must do that when it has the filename chosen by the user.

Return Value:
The filename and path of the file which the user selected.

Parameters:
caption The caption which appears in the title bar of the dialog, eg "Save Editor File"
fileTypes String specifying the types of files which the user can view. The string looks like this : 
Description of FileType|Extension|Description of FileType|Extension
Using a pipe character | (chr$(127)) to seperate each part.

For example: 
file=openDialog("Open Text File","Text Files (*.txt)|*.txt|All Files (*.*)|*.*")
[initDir] Optional. If specified sets the folder which is open when the dialog first appears.
Remarks:


See Also:


Example:
(Note: You will need to include the GUI constants file for this example to work)